8.1. Кнопка, которая пока молчит
В прошлом уроке в проекте появился JavaScript: переменная clicks, команда console.log и тег script в конце страницы. Скрипт запускается, выводит сообщение в консоль — но сама кнопка по-прежнему ничего не делает. Нажимаешь — и ничего не происходит.
Это не поломка. Кнопка нарисована в HTML, а переменная живёт в JavaScript. Пока между ними нет связи, браузер считает кнопку просто прямоугольником с текстом и даже не сообщает скрипту, что кто-то нажал.
Сегодня мы эту связь построим. В конце урока кнопка #magicButton будет считать клики: число увеличится и появится на странице.
8.2. Что такое событие
Событие — это действие, которое произошло на странице: пользователь щёлкнул мышью, нажал клавишу, навёл курсор, прокрутил колесо. Событием может быть и действие самого браузера: страница загрузилась, окно изменило размер, форма отправилась.
Браузер замечает такие действия постоянно, даже без JavaScript. Событие — это факт: «вот здесь произошёл клик». Реагировать на него или нет, решает программа.
У каждого события есть имя. В коде оно записывается строкой в кавычках. Самые частые:
'click'— нажатие кнопкой мыши или пальцем по экрану;'keydown'— нажатие клавиши на клавиатуре;'mouseover'— курсор навели на элемент;'load'— страница или картинка закончила загружаться.
Нас интересует 'click': оно возникает, когда пользователь нажимает на кнопку и отпускает кнопку мыши над ней. Имя пишется маленькими латинскими буквами и в кавычках. Click или 'onclick' — уже не то имя, браузер такое событие не узнает.
8.3. Обработчик — это функция
Обработчик — это функция, которую браузер вызывает, когда происходит событие. Мы не вызываем её сами: мы заранее говорим браузеру «когда здесь щёлкнут, выполни вот эту функцию», и он выполняет её в нужный момент.
Функция — это именованный блок кода. Пока функция не вызвана, её тело не выполняется: это инструкция, которая лежит наготове.
function magicClick() {
console.log('Кнопка нажата!');
}
В этом примере есть имя magicClick, пустые скобки и тело в фигурных скобках. Никакого вывода в консоль пока не произойдёт: мы только описали действие. Консольное сообщение появится в тот момент, когда функция будет вызвана — например, по клику.
magicClick() или по клику, если функция назначена обработчиком.
8.4. Объявление функции и её вызов
Разберём два действия, которые новички часто путают. Объявить функцию — описать её и дать имя. Вызвать функцию — заставить её выполниться прямо сейчас.
function magicClick() {
console.log('Клик!');
}
magicClick();
Здесь сверху функция объявлена, а снизу вызвана. Если убрать последнюю строку, в консоли будет пусто. Если оставить только вызов без объявления, браузер выдаст ошибку: magicClick is not defined — «такой функции нет».
Разница видна по скобкам. Запись magicClick без скобок означает саму функцию: её можно передать, сохранить в переменную, отдать браузеру. Запись magicClick() со скобками означает «выполни её немедленно». Для обработчика нужна именно первая форма: браузер сам решит, когда её запускать.
8.5. Как передать функцию, а не её результат
Теперь главная ловушка урока. Чтобы назначить обработчик, функцию передают по имени, без скобок:
button.addEventListener('click', magicClick);
Если случайно добавить скобки, произойдёт совсем другое:
button.addEventListener('click', magicClick());
Во второй строке браузер видит magicClick() и сразу вызывает функцию — ещё при загрузке страницы, до всякого клика. Функция выполняется и возвращает undefined, потому что return в ней нет. Именно это значение попадает в addEventListener вместо обработчика: функция вызовется сразу, а клики останутся без реакции.
Проверить себя просто: если после имени функции в обработчике стоят скобки — это почти наверняка ошибка. Скобки нужны в момент вызова, а не в момент передачи.
addEventListener('click', magicClick()) — вызов вместо функции. Функция сработает один раз при загрузке страницы, а клики перестанут работать. Правильно: addEventListener('click', magicClick) — без скобок.
8.6. Находим кнопку по id
Прежде чем назначать обработчик, скрипт должен понять, о какой именно кнопке речь. На странице может быть несколько кнопок, и клик по каждой должен обрабатываться по-своему. Помогает id — уникальное имя элемента, которое мы задали ещё в уроке 3:
<button class="magic-button" id="magicButton">✨ МАГИЯ! ✨</button>
Из JavaScript элемент ищут так:
const button = document.getElementById('magicButton');
Разберём по частям. document — главный объект страницы. getElementById — команда «найди элемент по id». В скобках — строка с именем id, без решётки: 'magicButton', а не '#magicButton'. Результат сохраняется в переменную button.
Имя в скрипте должно совпадать с именем в разметке символ в символ. magicButton и magicbutton — разные id: JavaScript различает большие и маленькие буквы. Если id не найден, команда вернёт null — особое значение «ничего нет». Тогда следующая строка с button.addEventListener выдаст ошибку.
8.7. Подписываемся на событие: addEventListener
Команда addEventListener переводится как «добавить слушателя события». Она говорит браузеру: «следи за этим элементом и, когда произойдёт такое-то событие, вызови такую-то функцию».
const button = document.getElementById('magicButton');
function magicClick() {
console.log('Кнопка нажата!');
}
button.addEventListener('click', magicClick);
У команды два обязательных аргумента. Первый — имя события строкой: 'click'. Второй — функция-обработчик без скобок: magicClick. Между аргументами стоит запятая, после всей строки — точка с запятой.
Порядок строк в этом примере удобный, но не единственный: функцию можно объявить и до поиска кнопки. Важно другое — к моменту вызова addEventListener кнопка должна быть найдена, а функция — существовать. На один элемент можно повесить несколько обработчиков одного события: браузер вызовет их всех по порядку.
8.8. Что происходит по шагам
Соберём последовательность целиком, чтобы не потеряться в строках.
- Страница загружается, браузер строит разметку сверху вниз.
- Дойдя до конца
body, браузер выполняет скрипт. - Скрипт находит кнопку и объявляет функцию
magicClick. addEventListenerподписывает кнопку на событие'click'.- Скрипт заканчивается, страница ждёт действий пользователя.
- При клике браузер создаёт событие и вызывает подписанную функцию.
Обработчик не «срабатывает однажды»: он остаётся подписанным до конца жизни страницы, пока его не снимут. Сколько раз нажмёшь, столько раз функция и выполнится.
8.9. Счётчик: clicks = clicks + 1
Теперь вернёмся к переменной clicks из урока 7. Она хранит число нажатий. Начальное значение — ноль:
let clicks = 0;
При каждом клике число должно увеличиваться на единицу. Записывается это так:
clicks = clicks + 1;
Строка выполняется справа налево. Сначала JavaScript берёт текущее значение clicks, прибавляет единицу, а потом кладёт результат обратно в переменную. Был ноль — станет один; при следующем клике — два.
Короткая запись clicks += 1; делает то же самое. Ещё короче — clicks++;, но полная форма нагляднее: видно, что новое значение вычисляется из старого.
Добавим увеличение в обработчик:
function magicClick() {
clicks = clicks + 1;
console.log(clicks);
}
Обрати внимание: браузер сам ничего не считает. Счётчик — это наша переменная и наша строка сложения. Если убрать clicks = clicks + 1, функция будет выполняться, но число останется нулём. Если убрать только console.log, число продолжит расти, но мы этого не увидим.
8.10. Показываем число на странице
Консоль видит разработчик, а зрителю нужно число на экране. Добавим в разметку отдельный элемент с id clickCount. Это обычный HTML-блок, в нём пока стоит ноль:
<div class="game-container">
<h1>Волшебная кнопка</h1>
<p class="subtitle">Кликай и создавай магию!</p>
<button class="magic-button" id="magicButton">✨ МАГИЯ! ✨</button>
<div id="clickCount">0</div>
</div>
Найти этот блок из скрипта можно той же командой, что и кнопку:
const counter = document.getElementById('clickCount');
Осталось записать в него новое число. Для этого служит свойство textContent — «текстовое содержимое элемента». Присваивание заменяет весь текст внутри элемента на то, что стоит справа:
counter.textContent = clicks;
Обрати внимание: textContent заменяет текст целиком, а не добавляет новый. Если вызвать его дважды, останется только последнее значение. Для счётчика это и нужно: каждое новое число заменяет предыдущее.
Соберём полный скрипт. Замени им содержимое script из урока 7: clicks объявляется только один раз, иначе браузер сообщит о повторном объявлении переменной.
let clicks = 0;
const button = document.getElementById('magicButton');
const counter = document.getElementById('clickCount');
function magicClick() {
clicks = clicks + 1;
counter.textContent = clicks;
console.log(`Кликов: ${clicks}`);
}
button.addEventListener('click', magicClick);
Вот живой счётчик, собранный по этому коду. Нажимай и следи за числом.
кликов
clicks хранит число в памяти, а counter.textContent выводит его на страницу. Обновишь только переменную — на экране останется старое значение. Обновишь только текст — следующий клик посчитает от старого числа. Нужны обе строки.
8.11. onclick в атрибуте и addEventListener
Есть и второй способ назначить обработчик — записать его прямо в HTML-атрибут onclick:
<button class="magic-button" id="magicButton" onclick="magicClick()">✨ МАГИЯ! ✨</button>
Работает это так же: по клику браузер вызовет magicClick. Но у атрибута есть ограничения.
- Код смешивается с разметкой. HTML отвечает за структуру, JavaScript — за поведение; атрибут ломает это разделение.
- Обработчик только один. Второе назначение
onclickзаменит первое, аaddEventListenerдобавляет сколько угодно обработчиков. - Трудно снять. Для
addEventListenerесть парная командаremoveEventListener, для атрибута такой удобной пары нет. - Длинный код неудобно читать. Пара строк ещё помещается в атрибут, а настоящий обработчик — нет.
Поэтому в проекте используем addEventListener: код поведения собран в одном месте, а разметка остаётся разметкой.
8.12. Порядок выполнения и место для скрипта
Браузер читает файл сверху вниз и выполняет JavaScript там, где встретил тег script. Поэтому к моменту поиска кнопки она уже должна быть построена.
Если поставить скрипт в head или в начало body, он выполнится раньше, чем браузер дойдёт до кнопки. getElementById вернёт null, а следующая строка выдаст ошибку:
Uncaught TypeError: Cannot read properties of null (reading 'addEventListener')
Читается она так: «нельзя прочитать свойство addEventListener у значения null». Искать нужно не в JavaScript, а в порядке строк: элемент ещё не существует. Именно поэтому в уроке 7 мы поставили script в самый конец body, после всей разметки.
Внутри скрипта порядок тоже удобнее держать логичным: найти элементы, объявить функцию, подписаться на событие. Объявление функции JavaScript видит во всём скрипте, а элементы — только после того, как они появились в разметке.
null и addEventListener, первым делом проверь, где стоит script. Он должен быть в конце body, после кнопки и счётчика, а не в head.
8.13. Как снять обработчик
Иногда реакция нужна не всегда: например, после третьего клика счётчик должен остановиться. Для этого есть команда removeEventListener. У неё те же два аргумента, что и у addEventListener:
button.removeEventListener('click', magicClick);
Главное условие — передать ту же самую функцию, а не её копию и не вызов. Функция magicClick объявлена по имени, значит у браузера есть ссылка, по которой он узнаёт обработчик. Безымянную функцию снять нельзя: у неё нет имени, по которому её можно найти.
button.removeEventListener('click', magicClick);
console.log('Обработчик снят');
Если выполнить эти строки — например, из другого обработчика или из консоли, — кнопка отпишется от события. После этого клики по magicButton перестанут увеличивать счётчик.
removeEventListener('click', magicClick) работает, а removeEventListener('click', magicClick()) — нет: скобки снова вызывают функцию, а не передают её. Имя без скобок — общее правило для обоих методов.
8.14. Итог урока
Кнопка в проекте ожила: она замечает клики, увеличивает счётчик и показывает новое значение. Это первый обработчик события в курсе, и устроен он так же, как в настоящих приложениях.
- Событие — действие пользователя или браузера, например
'click'. - Обработчик — функция, которую браузер вызывает при событии.
- Объявление функции описывает действие, вызов — выполняет его сейчас.
- В
addEventListenerфункция передаётся по имени, без скобок. getElementByIdнаходит элемент по id, аtextContentменяет его текст.- Скрипт стоит в конце
body, потому что ищет элементы, которые уже должны быть на странице.